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UNIVERSAL ROUTINE FOR 
REVIEWING AND EXERCISING SOFTWARE OBJECTS 

Cross-Reference To Related Application 

This application claims the benefit of U.S. Provisional Application No. 60/231,651 filed 
5 September 11, 2000 and entitled "OBJECT BROWSER USING TYPE LIBRARIES". 

Technical Field 

This invention relates to reviewing and testing software objects in a program. More particularly, this 
invention relates to testing objects in a program by selecting software objects for review and 
exercising a selected software object with an assortment of methods and parameters selectable by the 
S user. 

/"f Background of the Invention 

IsJ The development of new computer programs or software has been greatly advanced both as to 
(n rehabihty and speed of development by the advent of object-oriented technology, i.e. object 

programming. In object programming, an object is a software package containing methods and data 
\B elements on which the methods operate. The methods in the object operate on the data elements to 

produce a desired result. A computer program may be organized into objects that together perform 
]z the desired operations of the program. To work together the objects send messages to each other. 

The messages specify a receiver object, a method to be performed by the receiver object and data to 

be used by the receiver object when performing the method. The receiver object may respond with a 
20 message to the sending object. Exemplary program languages for writing object-oriented programs 

include C++ and Smalltalk. 

Another advance in the writing of computer programs has been the Component Object Module 
(COM) progranaming system developed by Microsoft Corporation. COM objects are designed to be 
standard building components useful for building many types of programs. Just as electrical circuit 
25 elements such as resistors, capacitors, inductors and active devices are components in circuit designs, 
so also COM objects are components in program designs. 
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A problem that remains in the development of programs is the review and testing of objects or COM 
objects. To test objects in the program, the developer will typically spend a great deal of time 
writing code to test each object with an assortment of messages containing methods and parameters 
to exercise the object. The testing and debugging of the objects in a new program may take a 
significant amount of time after the program is written. 

Summary of the Invention 
hi accordance with the present invention, the above and other problems in testing programs are 
solved by a universal routine controlled through a user interface and implementing logical operations 
for reviewing and testing objects in the program. Through the user interface the reviewer selects 
objects to be exercised and exercises them with selected methods and parameters. The object under 
review is cocreated so that the cocreated object is exercised. The reviewer selects parameters, if 
any, for use by the selected method in the object when the selected method is invoked. The selected 
method on the object is called; the parameters for the method are retrieved and the method is 
invoked. Li effect the object under review is sent a message containing a selected method to be 
performed with selected parameters. The result of exercising the object with the selected method 
and selected parameters is logged for review. A dialog between the user/reviewer and the objects 
under test continues until all objects to be reviewed have been exercised. 

The invention may be implemented as a computer process, a computing system or as an article of 
manufacture such as a computer program product or computer readable media. The computer 
program product may be a computer storage media readable by a computer system and encoding a 
computer program of instructions for executing a computer process. The computer program product 
may also be a propagated signal on a carrier readable by a computing system and encoding a 
computer program of instructions for executing a computer process. 

These and various other features as well as advantages, which characterize the present invention, will 
be apparent from a reading of the following detailed description and a review of the associated 
drawings. 

Brief Description of the Drawings 
FIG, 1 shows an operational flow of logical operations performed by the universal routine in the 
selection and exercising of objects in accordance with one embodiment of the present invention. 
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FIG. 2 illustrates the data flow between architectural elements of a system in which the operations of 
FIG. 1 are performed. 

FIG. 3 illustrates one example of a computing environment in which embodiments of the present 
invention may be implemented. 

5 FIG. 4 shows an operational flow of logical operations to perform the selection and exercising of 
objects in accordance with another embodiment of the invention. 

FIG. 5 illustrates the dialog box displayed by operation 423 in FIG, 4 whereby the user/reviewer 
selects parameters for use by the method in exercising the object under review. 

Detailed Description of Embodiments of Invention 
P The operational flow of logical operations of the universal routine for reviewing and testing objects 
'f"^ in one embodiment of the invention is shown in FIG. 1. The operative elements used in performing 
the logical operations and the data flow between operative elements are shown in FIG. 2. The 
operational flow of the imiversal routine is entered from the main program through start connector 
' 10. Resource and select module 12 retrieves the information available about the objects under 
M review including the objects, their interfaces, methods and parameters. Engine command processor 
III 40 and user interface driver 42 in FIG. 2 work together to perform the operations in FIG. L The user 
Iz. interface driver 42 sends requests 44 to the type library (TLB) store 45 and the TLB store replies 46 
with COM objects, methods and parameters. Resource and select module 12 also retrieves user 
input to the operational flow that indicates the object selected for the review, whether the object is to 
20 be cocreated or an instance or copy already exists, and what method is to be invoked to exercise the 
object. In this regard, the user interface driver 42 sends requests 47 to the input dialog (DLG) 48 and 
the input DLG 48 replies 49 with object and method selections and commands from the 
user/reviewer. 

In an alternative embodiment, the manual input might be replaced by a XML file input to the engine 
25 conmiand processor 40. Further, the engine command processor might generate an XML file output 
effectively automating the testing operation. 
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Test complete operation 14 performed in the engine command processor 40 detects whether more 
objects are to be exercised or more methods on a selected object are to be invoked. If all of the 
objects have been exercised, and if no further selections are provided by the resource and select 
module 12, the operation flow branches YES to exit connector 16. The operational flow in this 
5 situation returns to the main program. If the test complete operation 14 detects there are more 
objects to be exercised either because another object has been selected or a method or more 
parameters have been selected, the operation flow branches NO to cocreate test operation 18. 

Cocreate test operation 18 is testing whether the object under review has to be cocreated or is already 
in an object store 40 (FIG. 2) ready to be exercised. If an instance of the object under review has not 

10 been created for the exercise, then the operational flow branches YES to cocreate module 20. 

H=n Cocreate module 20 creates an instance of the object under review. The instance of the object is 

stored in the object store 50 by the engine command processor 40 using add-to-object-store operation 

"4^ 22. The addition of the object under review to the object store is logged by log result operation 24, 

III and the result is stored in log file 52. The operation flow then returns to resource and select module 

M 12 for more information to be retrieved in the review and test operations. 

^3 If an instance of the object under review is already in the object store, the operational flow branches 
y NO from cocreate test operation 18 to dialog and exercise module 26. Module 26 retrieves the 

selected object (instance of object under review) from the object store and the selected method for 
^ " exercising the selected object. Module 26 then displays a dialog box to the reviewer providing 
20 appropriate parameter choices for the selected object and method. After the reviewer makes the 
parameter choices, module 26 retrieves the choices and invokes the selected method on the selected 
object using the parameter choices. A possible result of invoking the method may be the creation of 
another object. If so, module 26 calls add-to-object-store operation 22 which adds the new object to 
object store 50. If the result of invoking the method produces a result from exercising the object 
25 without creating a new object, the result of the exercise is logged in log file 52 by log result 
operation 24. The operational flow then retums to the resource and select module 12 for more 
selections by the reviewer. When all reviews and tests of the objects in the program have been 
completed, the operational flow branches YES to exit connector 16. 
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FIG. 3 illustrates an example of a suitable computing system environment 100 on which the 
invention maybe implemented. The computing system environment 100 is only one example of a 
suitable computing environment and is not intended to suggest any limitation as to the scope of use 
or functionality of the invention. Neither should the computing environment 100 be interpreted as 
5 having any dependency or requirement relating to any one or combination of components illustrated 
in the exemplary operating environment 100. 

The invention is operational with numerous other general purpose or special purpose computing 
system environments or configurations. Examples of well known computing system, environments, 
and/or configuration that may be suitable for use with the invention include, but are not limited to, 

10 personal computers, server computers, land-held or laptop devices, multiprocessor systems, 

microprocessor-based systems, set top boxes, programmable consumer electronics, network PCs, 

:Jf minicomputers, mainframe computers, distributed computing environments that include any of the 

' J above systems or devices, and the like. 

The invention may be described in the general context of computer-executable instructions, such as 
¥i program modules, being executed by a computer. Generally, program modules include routines, 
Q programs, objects, components, data structures, etc. that perform particular tasks or implement 
Id particular abstract data types. The invention may also be practiced in distributed computing 

environments where tasks are performed by remote processing devices that are linked through a 
communications network, hi a distributed computing environment, program modules may be located 
20 in both local and remote computer storage media including memory storage devices. 

With reference to FIG. 3, an exemplary system for implementing the invention includes a general 
purpose computing device in the form of a computer 110. Components of computer 110 may 
include, but are not limited to, a processing unit 120, a system memory 130, and a system bus 121 
that couples various system components including the system memory to the processing unit 120. 
25 The system bus 121 may be any of several types of bus structures including a memory bus or 

memory controller, a peripheral bus, and a local bus using any of a variety of bus architectures. By 
way of example, and not limitation, such architectures include Industry Standard Architecture (ISA) 
bus. Micro Channel Architectures (MCA) bus. Enhanced ISA (EISA) bus. Video Electronics 
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Standards Association (VESA) local bus, and Peripheral Component Interconnect (PCI) bus also 
known as Mezzanine bus. 

Computer 110 typically includes a variety of computer readable media. Computer readable media 
can be any available media that can be accessed by computer 110 and includes both volatile and 
5 nonvolatile media, removable and non-removable media. By way of example, and not limitation, 
computer readable media may comprise computer storage media and communication media. 
Computer storage media includes both volatile and nonvolatile, removable and non-removable media 
implemented in any method or technology for storage of information such as computer readable 
instructions, data structures, program modules or other data. Computer storage media includes, but 
10 is not limited to, RAM, ROM, EEPROM, flash memory or other memory technology, CDE-ROM, 
digital versatile disks (DVD) or other optical disk storage, magnetic cassettes, magnetic tape, 
magnetic disk storage or other magnetic storage devices, or any other medium which can be used to 
'4 store the desired information and which can be accessed by computer 110. Communication media 
I . I typically embodies computer readable instructions, data structures, program modules or other data in 
:S a modulated data signal such as a carrier wave or other transport mechanism and includes any 
: information delivery media. The term "modulated data signal" means a signal that has one or more 
= i of its characteristics set or changed in such a manner as to encode information in the signal. By way 
of example, and not limitation, communication media includes wired media such as a wired network 
O or direct-wired connection, and wireless media such as acoustic, RF, infrared and other wireless 
20 media. Combinations of any of the above should also be included within the scope of computer 
readable media. 

The system memory 130 includes computer storage media in the form of volatile and/or nonvolatile 
memory such as read only memory (ROM) 131 and random access memory (RAM) 132. A basic 
input/output system 133 (BIOS), containing the basic routines that help to transfer information 
25 between elements within computer 110, such as during start-up, is typically stored in ROM 131, 

RAM 132 typically contains data and/or program modules that are immediately accessible to and/or 
presently being operated on by processing unit 120. By way of example, and not limitation, FIG. 3 
illustrates operating system 134, application programs 135, other program modules 136, and program 
data 137. 



-6- 



MS # 163104.2 
M&G#40062,116-US-U1 

The computer 110 may also include other removable/non-removable, volatile/nonvolatile computer 
storage media. By way of example only, FIG. 3 illustrates a hard disk drive 140 that reads from or 
writes to non-removable, nonvolatile magnetic media, a magnetic disk drive 151 that reads from or 
writes to a removable, nonvolatile magnetic disk 152, and an optical disk drive 155 that reads from 
or writes to a removable, nonvolatile optical disk 156 such as a CD ROM or other optical media. 
Other removable/non-removable, volatile/nonvolatile computer storage media that can be used in the 
exemplary operating environment include, but are not limited to, magnetic tape cassettes, flash 
memory cards, digital versatile disks, digital video tape, solid state RAM, solid state ROM, and the 
like. The hard disk drive 141 is typically connected to the system bus 121 through an non-removable 
memory interface such as interface 140, and magnetic disk drive 151 and optical disk drive 155 are 
typically connected to the system bus 121 by a removable memory interface, such as interface 150. 

The drives and their associated computer storage media discussed above and illustrated in FIG. 3, 
provide storage of computer readable instructions, data structures, program modules and other data 
for the computer 110. In FIG. 3, for example, hard disk drive 141 is illustrated as storing operating 
system 144, application programs 145, other program modules 146, and program data 147. Note that 
these components can either be the same as or different from operating system 134, application 
programs 135, other program modules 136, and program data 137. Operating system 144, 
application programs 145, other program modules 146, and program data 147 are given different 
numbers here to illustrate that, at a minimum, they are different copies. A user may enter commands 
and information into the computer 100 through input devices such as a keyboard 162 and pointing 
device 161, commonly referred to as a mouse, trackball or touch pad. Other input devices (not 
shown) may include a microphone, joystick, game pad, satelHte dish, scanner, or the hke. These and 
other input devices are often connected to the processing unit 120 through a user input interface 160 
that is coupled to the system bus, but may be connected by other interface and bus structures, such as 
a parallel port, game port or a universal serial bus (USB). A monitor 191 or other type of display 
device is also comected to the system bus 121 via an interface, such as a video interface 190. In 
addition to the monitor, computers may also include other peripheral output devices such as speakers 
197 and printer 196, which may be connected through a output peripheral interface 190. 

The computer 110 may operate in a networked environment using logical connections to one or more 
remote computers, such as a remote computer 180. The remote computer 180 may be a personal 
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computer, a server, a router, a network PC, a peer device or other common network node, and 
typically includes many or all of the elements described above relative to the computer 110, although 
only a memory storage device 181 has been illustrated in FIG. 3. The logical connections depicted in 
FIG. 3 include a local area network (LAN) 171 and a wide area network (WAN) 173, but may also 
5 include other networks. Such networking environments are commonplace in offices, enterprise-wide 
computer networks, intranets and the Internet. 

When used in a LAN networking environment, the computer 110 is connected to the LAN 171 
through a network interface or adapter 170. When used in a WAN networking environment, the 
computer 110 typically includes a modem 172 or other means for establishing communications over 

10 the WAN 173, such as the Internet. The modem 172, which may be internal or extemal, may be 

connected to the system bus 121 via the user input interface 160, or other appropriate mechanism. In 

JSf a networked environment, program modules depicted relative to the computer 110, or portions 

thereof, may be stored in the remote memory storage device. By way of example, and not limitation, 

1 : j FIG. 3 illustrates remote application programs 185 as residing on memory device 181. It will be 

B appreciated that the network connections shown are exemplary and other means of establishing a 

; communications link between the computers may be used. 

hj A computing device, such as computing system 100, typically includes at least some form of 
• 5 computer-readable media. Computer readable media can be any available media that can be 

accessed by the computing system 100. By way of example, and not limitation, computer-readable 
20 media might comprise computer storage media and communication media. 

Computer storage media includes volatile and nonvolatile, removable and non-removable media 
implemented in any method or technology for storage of information such as computer readable 
instructions, data structures, program modules or other data. Computer storage media includes, but 
is not limited to, RAM, ROM, EEPROM, flash memory or other memory technology, CD-ROM, 
25 digital versatile disks (DVD) or other optical storage, magnetic cassettes, magnetic tape, magnetic 
disk storage or other magnetic storage devices, or any other medium that can be used to store the 
desired information and that can be accessed by the computing system 100. 
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Communication media typically embodies computer-readable instructions, data structures, program 
modules or other data in a modulated data signal such as a carrier wave or other transport mechanism 
and includes any information delivery media. The term "modulated data signal" means a signal that 
has one or more of its characteristics set or changed in such a manner as to encode information in the 
5 signal. By way of example, and not limitation, communication media includes wired media such as 
a wired network or direct-wired connection, and wireless media such as acoustic, RF, infrared, and 
other wireless media. Combinations of any of the above should also be included within the scope of 
computer-readable media. Computer-readable media may also be referred to as computer program 
product. 

10 In FIG. 4, the operational flow of another embodiment of the invention for exercising an object 

enters at start terminal 401. Load operation 403 parses TLBs (type library) into information about a 
^0 component. A component is an object that encapsulates both data and code, and provides a well- 
■ specified set of available services. A component for example might be a COM object. The type 
l^, libraries are files storing information about interfaces, parameters, methods, enumerations, constants, 
:f5 and other attributes of a component. The logical operations illustrated in the operational flow of 
= FIG. 4 are processed in processing engine 40 and the user interface driver 42 in FIG. 2. Create TLB 
store operation 405 builds the TLB store in order to cache parsed information from the TLBs for 
easier use later in the operations of the universal routine for reviewing and testing objects. Receive 
O operation 407 receives a user input whereby the user can control the exercising of an object. These 
'20 user inputs allow the user to select whether the object is to be cocreated, whether an object is 
available firom the object store, and what method is to be executed in exercising the object. 

From the receive operation 407, the decision operation 409 tests whether there are more object 
exercises remaining. If the exercising of objects is complete, the operational flow branches YES to 
the return terminal 411 which returns program control to the caUing or main program that called the 
25 exercise operations. If the exercise of the COM object is not complete, then operational flow 
branches NO to cocreate test operation 413 to detect whether the user has selected an object that 
must be cocreated to be exercised. If the user input specifies an object to be cocreated, then the 
operational flow branches YES from operation 413 to cocreate operation 415. 
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Cocreate operation 415 creates an instance of the object to be exercised, and store operation 417 adds 
the cocreated object to the object store 50 in FIG. 2. After the cocreated object is in the object store, 
the operational flow passes to log operation 419 that logs the co-creation addition of the object to the 
object store. From log operation 419, the operational flow returns to the receive selections operation 
5 407. Receive operation 407 will be looking to see if the next user input is another co-creation of an 
object for exercising or whether the user has selected an object from the object store to be exercised. 
Receive selections operation 407 will also be looking to see whether the user has specified any 
method for exercising the object. Since the exercising of objects is not complete, the operational 
flow branches NO through decision operation 409 to cocreate test operation 413. 

10 Assuming the user input was the selection of an object from the object store and the identification of 
a method for exercising the object, the operational flow will branch NO from cocreate test operation 
;5 413 to call method operation 421. Call method operation 421 calls the selected method on the 
SI selected object from the object store 50. Display operation 423 renders the input dialogue window 
\,i for the user to indicate parameter choices for exercising the selected object. 

^^1 An example of the dialogue window is illustrated in FIG. 5. In FIG. 5, the dialogue box 502 lists the 
O parameters available for exercising the COM object. Once a parameter is selected, the choices for 
u I that parameter appear in dialogue box 504. The user may then choose the parameter from those 
]^ displayed in dialogue box 504, and the choice will appear as the current parameter choice in dialogue 

box 506. Get operation 425 gets the parameters selected by the user in using the input dialogue 
20 window of FIG. 5. When get operation 425 has retrieved the parameters, invoke operation 427 
invokes the method to exercise the selected object in accordance with the chosen method and the 
parameters retrieved in operation 425. Operation 429 interprets the result of the method exercising 
the object. These results may be the exercising of the selected object or the exercised object may 
have created another object and specified available methods, parameters and a timestamp. 

25 If the result of invoking the method on the object being exercised is the creation of another object, 
detect operation 431 will detect the creation of an additional object or the additional object so that 
operation flow branches YES to store operation 417. Store operation 417 adds the additional object 
to the object store. From store operation 417, the operational flow passes to log operation 419 to log 
the operation, the parameters and the result; in this case, an additional object in the object store 50 
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produced by invoking the method on the object being exercised in operation 427. If the result 
interpreted in interpret operation 429 is the performance of the selected method on the selected 
object given the selected parameters and does not result in the creation of another object, then the 
operational flow passes through detect operation 431 and branches NO to log operation 419. In this 
5 situation, log operation 419 logs in log file 52 the operation, the parameters and the result of 
exercising the object with the parameters chosen. When the log operation 419 is complete, the 
operational flow returns to receive user input 407 operation. If there is no additional user input, 
detect operation 409 tells whether all objects have been tested and if so the operational flow exits at 
411. The reviewer may then examine log file 52 to debug or adjust the objects being reviewed and 
10 tested. 

33 The logical operations of the various embodiments of the present invention are implemented (1) as a 
:Ji sequence of computer implemented steps or program modules running on a computing system and/or 
' J (2) as interconnected machine logic circuits or circuit modules within the computing system. The 
ill implementation is a matter of choice dependent on the performance requirements of the computing 
=5 system implementing the invention. Accordingly, the logical operations making up the 
^ embodiments of the present invention described herein have been referred to variously as operations, 
ifi structural devices, acts or modules. It will be recognized by one skilled in the art that these 

operations, structural devices, acts and modules may be implemented in software, in firmware, in 
special purpose digital logic, and any combination thereof without deviating firom the spirit and 
20 scope of the present invention as recited within the claims attached hereto. 

Thus, the present invention is presently embodied as a method, apparatus, computer program product 
or computer readable media encoding a computer program for reviewing and testing objects in a 
computer program. While the invention has been particularly shown and described with reference to 
preferred embodiments thereof, it will be understood by those skilled in the art that various other 
25 changes in the form and details may be made therein without departing fi*om the spirit and scope of 
the invention. 
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